Text File | 1989-03-21 | 61.3 KB | 1,056 lines | [04] ASCII Text (0x0000)
paddle buttonDon't use; use hand-control button or button on the hand control.
pageThere are two types of pages. See display pages; memory pages.
PALAcronym for Phased Alternate Lines (a European color standard) or for Programmed Array Logic (a type of integrated circuit). Spell out on first occurrence.
paletteNote spelling.
parenthesis (sing.), parentheses (pl.)Note different spelling of singular and plural. See also punctuation.
part opener Most manuals don't need to be divided into parts; division into chapters is usually sufficient. Good candidates for division into parts would be manuals that describe two or more separate products or two or more mutually exclusive programs on the same disk, or manuals so long that division into parts is necessary to make the organization clearer to the reader.
Part numbers are always roman numerals: Part I, not Part 1.
partsBooks are divided into parts when each part deals with a distinct topic. Accordingly, parts take part titles to indicate that difference in subject matter. When your manual has parts, use roman numerals for part numbers.
Part I, Part II
In a manual with parts, chapter numbering continues uninterrupted from part to part.
In cross-references to specific parts, italicize the part title along with the title. Use a colon to separate the title from the part title when you refer to both. Use an em dash to separate the part number from the part title.
For more information, see the AppleIIgs System Disk User's Guide: PartII-System Utilities.
See also volumes.
PascalNote capitalization.
passive voiceWhenever possible, don't use; use active voice. Passive voice is sometimes appropriate and necessary-when using the active voice would require highly convoluted sentence structure or excessive anthropomorphism, for example-but rewrite to avoid passive voice if you can.
In training disks, a passive construction may be appropriate to avoid miscuing the reader-that is, when describing an action that the user is not supposed to try yet.
Explanation screen: An icon is selected by clicking it.
User-try screen: You try it. Click the icon.
pathnameOne word. Note the treatment of these similar terms: device name, filename, user name, volume name.
PCGenerally, don't use. Use personal computer for generic references and IBM PC to refer to the IBM personal computer. However, in certain documents-such as networking documents-where frequent references must be made to non-Apple systems, PC may be used to refer to IBM systems and MS-DOS systems. Don't use PC as a generic name for IBM PCs and MS-DOS compatibles without first specifying in the document the use of PC.
PC-DOSNote hyphenation and capitalization.
P-codeStands for pseudocode. Note capitalization and hyphenation.
percentOne word. (Exception to AmericanHeritage.) Always preceded by a numeral, no matter how small the value.
1 percent
It's OK to use the percent symbol (%) instead of the word percent in technical appendixes, specification lists, and tables, or when the word must appear so many times in a text passage that its use becomes cumbersome.
When describing a nonspecific quantity, use percentage, as in a small percentage of the population.
periodsSee ellipsis points.
peripheralAvoid as a noun, especially in user manuals. Use peripheral card or peripheral device.
peripheralcardNot accessorycard. When appropriate, be specific: controller card, interfacecard. Avoid peripheral as a noun, especially in user manuals.
peripheral slotDon't use; use expansion slot.
Phased Alternate Lines (PAL)Refers to a European color standard. Spell out on first occurrence.
Phillipsscrew, Phillips screwdriverNote capitalization and spelling. Not Phillips-head screw or Phillips-head screwdriver.
phone portDon't use; use modem port.
piggyback boardDon't use; use expansion board.
pinAlways use a numeral and a hyphen before pin when describing connectors: 9-pin, 11-pin, 25-pin, 50-pin. (Exception to the rule that numbers smaller than 10 are spelled out except when used as numerals per se.)
pinout (n.)One word.
pixelShort for picture element. Not synonymous with bit. Define on first occurrence.
plugNot maleconnector. See also connector.
plurals
n acronyms and abbreviations
To form the plural of an acronym or an abbreviation, add an s but no apostrophe.
ICs, RAMs, ROMs
n adjectives
Don't add s to an adjective unless necessary. For example, it's electronic circuit but electronics engineer. Other words that fall into this class of adjectives are graphic and graphics, communication and communications, numeric and numerics.
n letters, characters, symbols
To form the plural of a letter, character, or symbol, add an apostrophe and an s.
p's, 6's, +'s
n nouns
Don't use (s) to indicate that a noun can be either singular or plural. Spell out the singular and plural forms if necessary; if possible, rewrite to avoid either construction.
Incorrect: Initializing your hard disk(s)
Correct: Initializing your hard disk or disks
Preferable: Initializing hard disks
n product names
Form the plural of trademarked product names by adding the plural generic noun to the singular product name used as an adjective.
Incorrect: Macintoshes, Apple IIc's, LaserWriters
Correct: Macintosh computers, Apple IIc computers, LaserWriter printers
If a product name includes a generic noun as well as a trademarked adjective, form the plural as you would with any noun.
Apple 3.5 Drives, LocalTalk Custom Wiring Kits
n words as words
Form the plural of a word italicized to show that it is used as a word by adding an apostrophe and an s. Do not italicize the apostrophe or the s.
He had too many and 's in the sentence.
plus signNot plus symbol.
p.m.Note small caps and periods. (Exception to the rule that abbreviations do not include periods.)
P-machineStands for pseudomachine. Note capitalization and hyphenation.
point (n.)Use only when writing about font sizes. Don't use as a synonym for dot or to describe a place or spot on the screen.
point (v.)When describing the desktop interface, don't use point as a verb without first defining it for the reader.
First occurrence: Move the mouse to position the pointer on the Trash icon. (This action is called pointing.) Then press the mouse button to select the icon. (This action is called clicking the icon.)
Thereafter: Point to the Trash icon and click to select it.
Once the reader is familiar with basic mouse techniques, it's often not necessary to mention pointing at all.
Click the Trash icon or Select the Trash icon.
pointerOK in general references, but be specific whenever appropriate: arrow, crossbar, crosshair, I-beam, wristwatch. (Figure 16 gives an example of each of these pointers.) Not synonymous with cursor.
n Figure16 Pointers
pop up (v.), pop-up (adj.)Note hyphenation of adjective.
portOK only for a socket on the back of the computer. Don't capitalize the names of the ports: modem port, mouse port, printer port, SCSI port.
possessivesForm the possessive of a singular noun, including one that ends in s, by adding an apostrophe and an s.
the computer's power cord
the boss's husband
Form the possessive of a plural noun that ends in s by adding an apostrophe. Form the possessive of a plural noun that does not end in s by adding an apostrophe and an s.
the students' curriculum
children's requirements
Form the possessive of a proper noun or a proper name, including one that ends in s, by adding an apostrophe and an s. Form the possessive of a plural proper noun or proper name by adding an apostrophe.
Howard Hughes's official biography
the Joneses' computer
Rewrite to avoid forming a possessive of any product name, especially a product name such as Apple IIc, Apple IIgs, or Macintosh II.
PostScriptNote capitalization. However, this name should be in caps and small caps when it appears on the copyright page or in the colophon.
pound signDon't use; use number sign for this character: #.
power cordNot power cable.
power-down (n., adj.), power down (v.)OK in technical manuals. Don't use in user manuals; use switch off.
power off (v.)Don't use, especially in user manuals; use switch off.
power on (v.)Don't use, especially in user manuals; use switch on.
power-onlightNote hyphenation and lowercase.
power-up (n., adj.), power up (v.)OK in technical manuals. Don't use in user manuals; use switch on.
pre (prefix)Close up even when it forms a double vowel, as in preexisting.
preface Not all manuals need a preface, but it's often a good idea to include one, especially in longer manuals.
The preface can be used to tell the reader about the manual, to describe conventions such as special notation and boldfacing defined terms, and to outline what the reader will find where. As a rule, discussion of the product belongs in the text, not in the preface, although it is sometimes appropriate to include introductory information about the product in the preface.
The preface should have a title. "About This Manual" is often appropriate.
When referring to the preface of a manual (but not when referring to prefaces in general), capitalize the word preface.
See the Preface for more information.
The preface always begins on a new right-hand page. The first page has a page number but no running foot; all subsequent pages have a page number and a running foot. (Running feet follow the standard text convention: "Preface: Preface Title" on left-hand pages, "Level-one head" on right-hand pages.)
presetMay be used to describe a default setting.
MacWrite provides you with a ruler that has preset margins.
pressUse for keys on the keyboard, the mouse button, and mechanical buttons and switches. Don't use click, hit, tap, or type.
Press the Return key.
Press Command-Q to quit HyperCard.
See also click; enter; type.
print (v.)Not print out.
printed-circuit boardNote hyphenation.
printer portNote lowercase.
printheadTwo words.
printout (n.)One word.
print out (v.)Don't use; use print.
print serverTwo words.
printwheelTwo words.
productnamesFollow the capitalization style on the product's packaging. Don't use quotation marks around product names.
When you use a t or a r symbol, the product name must be an adjective.
Apple Desktop Bust device
Macintoshr computer
See also trademarks.
ProDOSUse only for the family of operating systems, which includes ProDOS 8 and ProDOS 16, or to refer to the ProDOS file system, which is used by both ProDOS 8 and ProDOS 16.
ProDOS 8Use for the original member of the ProDOS family, which was called just ProDOS before ProDOS 16.
ProDOS 16Use for the operating system developed for the Apple IIgs.
product training disksFollow the general rules given in this style guide, with the following exceptions:
n Use quotation marks, not italics, for words as words, letters as letters, and phrases as phrases, and for manual and disk titles.
n Use boldface, if available, for what the user is to type.
n Use underlining, not italics, for emphasis and for new terms. (If underlining is not available, use all caps.)
programlistingsUse computer voice.
Programmed Array Logic (PAL)Spell out on first occurrence.
programnamesDon't use computer voice. Capitalization should agree with the directory or catalog listing. Don't confuse a program name with a product name.
One of the program files used for AppleWorks is named APLWORKS.SYSTEM.
See also product names.
prompt (n., v., adj.)Avoid as a verb except in reference to what the system does when it displays an actual prompt character on the screen.
The prompt reminds you to do something.
The system then prompts you for information [with a prompt character].
The prompt character is sometimes a bracket.
pronunciationWhenever the pronunciation of an acronym is not self-evident, it's a good idea to give a pronunciation key. Use all caps for the stressed syllable; use a hyphen between syllables. Enclose the phonetic spelling in quotation marks.
SCSI (pronounced "SKUH-zee")
The Apple Publications Glossary provides pronunciation keys for many acronyms; don't invent your own pronunciation key unless the pronunciation isn't given in that document.
propellerNot propellor.
pseudo (prefix)Close up except before o, a proper noun, or a proper adjective. (Hyphenate in those cases.)
pulldown (v.), pull-down (adj.)Note hyphenation of adjective.
punctuationIn general, a punctuation mark should be in the same type style and font as the preceding word.
This address, called a vector, directs program control to a specified destination. [The second comma is italicized.]
See the glossary for the definition of word wrap. [The period is boldfaced.]
Note the following exceptions to this rule:
n Punctuation following computer voice in running text should be in the font of the overall sentence, not in computer voice, unless the punctuation mark is part of what actually appears on the screen or in the program listing.
n A closing parenthesis, bracket, or quotation mark should be in the same style as the opening mark. (For example, a closing parenthesis following an italicized word should be in plain style, not italic, unless all text between the parentheses is italicized.)
n When forming the plural of an italicized letter used as a letter, a number used as a number, or a word used as a word, neither the apostrophe nor the s is italicized.
For punctuation of lists, see list.
See also apostophes; commas; dashes; ellipsis points; hyphenation; quotation marks.
QuickDrawOne word. Note capitalization.
Quick Reference CardA copyright notice should appear on all Quick Reference Cards:
Copyright c <year> Apple Computer, Inc. All rights reseved.
quitYou quit, exit from, or leave a program. You never exit a program. Compare abort; cancel; halt; interrupt; stop.
quotationmarksUse curly opening and closing quotation marks except in computer voice and for Macintosh resource types in any font. (Table 4 gives the keystrokes necessary to generate curly quotation marks.)
Put periods and commas within quotation marks. If necessary for clarity, periods and commas can go outside, as in AN$="1". Semicolons, colons, question marks, and exclamation points go outside quotation marks unless they are part of an actual quotation.
When giving the name of a resource type, use straight single quotation marks in computer voice and place any punctuation outside the quotation marks.
Examples of resource types are 'FONT', 'NFNT', and 'cdev'.
Use quotationmarks, not quotemarks or quotes. (Quote is a verb; quotation is a noun or an adjective.)
Use quotation marks for
n cross-references to other sections of the manual
See "Maintenance" at the end of this chapter.
n cross-references to chapter titles
See Chapter 2, "Using MacProject."
n direct quotations
n letters as letters and words as words in product training disks
n manual and disk titles in product training disks
In manuals, use italics, not quotation marks, for terms after called, knownas, labeled, stands for, termed, and so on. (Use underlining for this purpose in training disks.) If a term is an on-screen element, however, don't use italics or underlining; use plain style for elements whose names are caps/lowercase, quotation marks for elements whose names are initial cap only.
INIT stands for initialize.
A folder named New Folder appears.
Click the check box labeled "Keep lines together."
radio buttonRefers to an on-screen button like the ones shown in Figure 17. Use only in technical documentation; use button in user manuals. No quotation marks around radio; no hyphen. See also button.
radio-frequency interference (RFI)Note hyphenation. Spell out on first occurrence.
radio-frequency(RF)modulatorNote hyphenation. Use RFmodulator only after spelling out on first occurrence.
RAMAcronym for random-access memory. Spell out on first occurrence.
RAM cache (n.)Lowercase c except when referring specifically to the Ram Cache option in the Control Panel.
RAM diskTwo words. Note capitalization.
random-accessmemory (RAM)Note hyphenation. Spell out on first occurrence.
re (prefix)Usually closed up, even when it forms a double vowel, as in reenter. Exception: re-create (as in re-create the file).
read-onlymemory (ROM)Note hyphenation. Spell out on first occurrence.
read/write (adj)Note slash, as in read/write memory.
real time (n.), real-time (adj.)Note hyphenation of adjective.
referenceDon't use as a verb; use refer to.
registerCapitalize names of specific registers, but don't capitalize the word register. Don't capitalize generic register names such as bank register and control register.
ResetThe key, which may be labeled with the word Reset or with a triangle symbol.
resizeNot size or grow. OK to write change the size of.
resize boxDon't use; use size box.
resources and resource typesA resource type name should be in computer voice and must have exactly four characters inside straight single quotations marks; for example, 'INIT', 'crsr', 'ICN#', and 'snd '. Resources themselves are often referred to by the same abbreviation as their resource type, but in a generic way; use regular text font in this case. Be sure to explain the abbreviation on first use. Avoid using the resource type name abbreviation unnecessarily.
Incorrect: Format 1 and format 2 snd resources . . .
Correct: Format 1 and format 2 sound resources . . .
Correct: Format 1 and format 2 'snd ' resources . . .
Correct: All initialization resources, or INIT resources, are of type 'INIT'.
Correct: Resources of type 'XCMD' are HyperCard external commands (also called ex-commands or XCMDs). When you write XCMDs . . .
Correct: To be adopted by the Control Panel, a cdev file must contain at least these resources: 'DITL', 'mach', . . . and 'cdev'.
ReturnThe key.
When you press Return, you generate a return character.
In technical manuals, it's OK to use the Return symbol ( o ) in lines of code and in tables. (To generate a Return symbol, press Option-O in 10-point Symbol.)
return characterNot carriage return or CR except in technical documentation when referring to ASCII character $0D. See also carriage return (CR).
RFIAbbreviation for radio-frequency interference. Spell out on first occurrence.
Right ArrowThe key. When referring to more than one of the arrow keys, arrow is lowercase (as in the arrow keys).
right-handAvoid except in reference to right-hand (recto) pages; use just right whenever possible.
rightmostNo hyphen.
right sideNot right-hand side.
road mapTwo words.
ROMAcronym for read-only memory. Spell out on first occurrence.
ROM diskTwo words. Note capitalization.
rowUse in describing a system that uses a grid of horizontal rows and vertical columns for placement of characters on the screen. Compare character position.
RS-242Note hyphenation.
RS-232-CNote hyphenation. Similar terms are hyphenated in the same way.
running feet The first page of each major division (front matter elements, chapters, appendixes, glossary, bibliography, and index) has a page number but not a running foot. All subsequent pages of the division have running feet.
In a book with chapters, running feet on left-hand pages consist of the word Chapter, the chapter number followed by a colon, and the chapter title in caps/lowercase. Running feet on right-hand pages consist of the most recent level-one head, in initial cap only. For example:
left-hand page Chapter 3: Putting Your Apple IIgs to Work
right-hand page Saving documents
In a chapter without level-one heads, use Chapter, the chapter number, colon, and chapter title for running feet on both right-hand and left-hand pages. For example:
both pages Chapter 3: Installing a Network Using LocalTalk Cables
In a manual without chapters, use the manual title (caps/lowercase) for running feet on left-hand pages, and the most recent level-one head (initial cap only) for running feet on right-hand pages.
run time (n.), run-time (adj.)Note hyphenation of adjective.
"sad Macintosh"Refers to the startup icon. Use quotation marks. Not sad Mac.
sans serif (adj.)No hyphen. Not sanserif.
save boxDon't use; use close box.
save on a diskNot save to disk.
ScrapbookThe desk accessory. Note capitalization.
screenNot display.
scrollAvoid using as a transitive verb.
Correct: Scroll through a document.
Correct: Scroll to view more of the document.
Incorrect: Scroll a document.
scroll boxTwo words.
SCSIAcronym for Small Computer System Interface. Spell out on first occurrence. The acronym is pronounced "SKUH-zee," so it is preceded by a, not an.
The Hard Disk 20 SC is a SCSI device.
SCSI cableNot SCSI system interface cable or SCSI interface cable. Be specific: SCSI system cable, SCSI peripheral cable.
SCSI cardNot SCSI interface card.
SCSI ID indicatorNot SCSI priority switch.
SCSI ID numberNot SCSI priority number.
SCSI ID switchNot SCSI priority switch setter or SCSI ID number switch.
SE Bus access portNo hyphen. Not accessory access port.
select Use select, not choose, for icons, windows, objects, graphic images, sections of text, or options in dialog boxes. Use choose for menu commands, including those in tear-off menus. See also choose. Compare deselect; highlight; unselected.
self-test (n., adj.)Note hyphenation. Don't use as a verb.
Serial A, Serial BPorts on the Macintosh XL. Note capitalization.
setup (n., adj.), setup (v.)One word except as a verb.
sexism, sexist languageSee fair language.
ShiftThe key. Note capitalization.
Shift-click (n., v., adj.)Note capitalization and hyphenation. (The hyphen denotes a combined keystroke.)
Small children may have trouble with the Shift-click.
Shift-click to extend the selection.
Use the Shift-click technique to select more than one icon.
Shift lockDon't use; use Caps Lock.
shortcutOne word. (Exception to American Heritage.)
signUse sign, not symbol, in the following terms: division sign, equal sign, greater-than sign, less-than sign, minus sign, multiplication sign, number sign, and plus sign.
signaled,signalingNot signalled,signalling.
signalsUse regular text font all caps for signal names. Use an en dash between the first and last signal names to indicate a range of signals. Begin active-low signal names with a slash, and use angle brackets to enclose two or more ranges in a set.
/CLK
</AD31-AD29,/AD7-/AD0>
SIMMAcronym for Single In-line Memory Module. Spell out on first occurrence.
sinceCan be used to mean because, but only if it begins a sentence. When using since in this way, however, make sure it isn't possible to misread the sentence as an expression of temporal relationship.
Correct: Since the address is passed on every call, you must . . .
Incorrect: Using access privileges is a good idea, since you probably won't want all users to make changes to the document.
Single In-line Memory Module (SIMM)Note capitalization. Note lowercase l. Spell out on first occurrence.
singlelettersSee letters as letters.
68000, 68020, . . . No comma. Don't use 68K for 68000. On first occurrence, use Motorola 68000 microprocessor; thereafter, the manufacturer need not be mentioned. See also x.
size (v.)Don't use; use resize or change the size of (in reference to a window or an object).
size boxTwo words. Not grow box or resize box.
size regionDon't use; use grow region.
sleeveDon't use. Use envelope or disk envelope to describe the paper holder for a 5.25-inch disk. Use jacket to describe the permanent cover that encases a 5.25-inch floppy disk.
slot1, slot 2, . . .Lowercase. Slot number is arabic.
SmartPortOne word. Note capitalization.
so-called (adj.)Don't italicize or use quotation marks around terms following so-called.
socketNot femaleconnector. See also connector; port.
Solid Apple keyDon't use; use Option key for the key marked with a solid Apple on Apple II-family keyboards that have two keys with Apple symbols.
If your manual may be read by users who are familiar with the term Solid Apple key, it's a good idea to explain the change in terminology.
source fileTwo words, except in reference to the Pascal predefined file type sourcefile.
Space barTwo words. Note capitalization.
spacecharacterNot blank or blankcharacter. OK to use just space, but in many cases it's necessary to remind the user that a space is actually a character and that margins, indention, word wrap, and page breaks can sometimes be affected by extra space characters (or a lack of them).
splashscreenDon't use; use openingdisplay, startup display, or startup screen.
square wave (n.), square-wave (adj.)Note hyphenation of adjective.
stand-alone (adj.)Note hyphenation. Don't use as a noun.
standard file dialog boxDon't use; use directory dialog box.
standard Apple IIRefers to any Apple II-family computer except the Apple IIgs.
start up (v.), startup (adj.)Avoid as a noun, especially in user manuals.
Start up the Macintosh.
Insert the startup disk.
See also boot.
startup diskPreferred term, but boot disk is OK in technical manuals.
startupdisplay, startup screenNot splash screen; startup display, startup screen, and openingdisplay are all OK.
statementNot necessarily the same as line. One line may contain several statements, and one statement may extend over several lines.
state namesUse the two-letter abbreviations shown in Table 5. (Both letters are capitalized in these abbreviations.)
n Table 5 Abbreviations for state names and territories
stepDon't capitalize, even in specific references.
step1, steps1and2, several steps
stereotypesSee fair language.
stopA general term meaning to cause a process, command, or program to cease. Compare abort; cancel; exit; halt; interrupt.
style (of type)Not typestyle or type style.
subdirectoryWhen describing the desktop interface in a user manual, use folder. See also folder.
Fig18
submenuUse when describing hierarchical menus (see Figure18). When the user drags the pointer to the side of a hierarchical menu command with a triangular indicator, a submenu appears.
subtitles, manualSee parts; volumes.
super high resolution (n.), super high-resolution (adj.)Note hyphenation in adjective.
Super Hi-ResRefers to the RGB high-resolution graphics displays on the Apple IIgs.
switch off, switch onPreferred to turn on and turn off. Don't use power down, power off, power on, or power up in user manuals.
symbolOK in a generic sense, as in the percent symbol (%). Don't use symbol when you mean character, letter, or digit.
Use sign, not symbol, in the following terms: division sign, equal sign, greater-than sign, less-than sign, minus sign, multiplication sign, number sign, and plus sign.
syntax descriptionsUse computer voice for literals (parts of the language, values, and so on), regular text font italics for metasymbols (artificial terms that have meaning only in your book and are to be replaced by a value or symbol), and plain style regular text font for brackets that enclose something that's optional. Pay close attention to punctuation.
Read ([file, ] var)
Use a hyphen or an embedded cap to connect two words that act as a single metasymbol.
n Figure 19The System file icon
Correct: source-file or sourceFile
Incorrect: sourcefile or source_file
The hyphen is preferred to the embedded cap because it avoids confusion of the metasymbol with a Macintosh routine name.
Be consistent when naming metasymbols; for example, don't alternate between commands and command-list.
systemUse as a broad term; a system includes a computer and any peripheral devices, accessories, and software.
n Figure 20The System Folder icon
System fileNote capitalization. Refers to the specifically named file (see Figure 19) in the System Folder. Compare system files.
system filesLowercase. Refers to any files used by the Macintosh to start itself up or to provide system-wide information. Compare System file.
System FolderNote capitalization. (See Figure 20.)
systemsoftwareNot systemssoftware.
Tab, tabCapitalize when referring to the key; use lowercase when referring to the character.
When you press Tab, you generate a tab character.
The tab character (HT, for horizontal tab) has ASCII value $09.
table Use tables whenever numbers or text would be clearer if presented in rows and columns.
Capitalization style for all parts of a table is initial cap only.
Column heads, spanners (heads to which at least two column heads are subordinate), row titles (heads in the leftmost column), and stubs (heads to which at least two row titles are subordinate) should be short and descriptive.
If it's necessary to subdivide a single table into sections, use horizontal rules to do so.
table caption Table captions include both a table number and a table title. Every table must have a caption; if a table is so simple that it needs no title, it should be reformatted as a multicolumn list.
Tables are numbered one-up by chapter. The table number consists of the word Table, the chapter number (or the letter P if the table is in the preface, or the letter of the appendix if the table is in an appendix), a hyphen, and the number of the table within the chapter. There is no punctuation following the table number.
Table P-1 [first table in the preface]Table 8-9 [ninth table in Chapter 8]Table C-5 [fifth table in Appendix C]
Table titles should be short and to the point; a line and a half should be considered the absolute maximum. Avoid using complete sentences for table titles.
Avoid changing type styles and fonts in table titles; for example, avoid using computer voice.
Capitalization style for table titles is initial cap only; there is no ending punctuation.
When a table continues onto a second page (either right-hand or left-hand), the table number is repeated, followed by the word continued in parentheses (all lowercase); the table title, rules, spanners, and column heads are also repeated. If the table will continue onto a left-hand page, the word continued (all lowercase) is also set at the bottom of the page that is being continued.
All tables should have an in-text reference to point the reader to the appropriate table at the appropriate point. In general, this reference belongs in the paragraph preceding the table. (Don't use references such as the table below; the vagaries of page breaks are such that the reference may fall at the bottom of a right-hand page and the table at the top of the following left-hand page.)
In-text references can follow five styles:
n standing alone as a complete sentence within parentheses: (See Table A-12.)
n at the end of the text sentence, in parentheses: Many menu commands have power-key equivalents (see Table 5-1).
n standing alone as a complete sentence without parentheses: See Table 5-5.
n standing alone as a sentence fragment within parentheses: The keyboard shortcuts (Table 7-3) allow you to choose commands without pulling down the menu.
n part of the main text sentence, without parentheses: The meanings of the different DIP switch positions are shown in Table 5-20.
You can use any combination of these styles, but be consistent for comparable purposes.
table notes and table footnotes Information that pertains to an entire table is generally set as a table note, before any table footnotes.
The table note begins with the word Note (initial cap only) followed by a colon. If it is essential that this information be more prominent than a table note allows, it can be added instead after the table title, in parentheses, with no capitalization or ending punctuation (even if it is a complete sentence).
When specific items within a table require footnotes, use the following symbols, in this order:
asterisk (*)
dagger (t,Option-t)
double dagger (|,Option-Shift-7 in the LaserWriter fonts Helvetica, Times, Courier, and Garamond)
section ($,Option-6)
paragraph (P,Option-7)
number (#)
The symbols *, t, and # are already superscript. The symbols |, $, and P need to be selected and made superscript. When more symbols are needed, they are doubled, in the same order.
tableofcontentsMost manuals of ten pages or more should have a table of contents, which always begins on a new right-hand page (almost always page iii).
The first page of the table of contents has a page number but no running foot; all subsequent pages have both a page number and the running foot "Contents" (for both right-hand and left-hand pages).
The table of contents should include part, chapter, and chapter-equivalent titles and all level-one, level-two, and level-three heads. If absolutely necessary, level-four heads can be included (but remember that a book long enough to need level-four heads will also have an index, and that most readers rely on the index rather than the table of contents when they want to locate a specific topic).
The wording, capitalization, punctuation, and spelling of all heads and titles must be exactly the same in the text as in the table of contents.
See also chapter tables of contents.
tag box Use a Warning tag box when the reader should be warned that an action on his or her part may cause bodily injury, damage to hardware or software, or loss of data.
Use an Important tag box to alert the reader to less serious-but still significant-potential trouble spots.
Use tag boxes sparingly; they lose much of their effectiveness if they appear too often. Don't use one tag box immediately after another, or immediately before or after an incidental box. (See incidental box.) Avoid sandwiching just a few lines of text between two tag boxes, or between a tag box and an incidental box. Don't use a tag box immediately after a text head.
Under normal circumstances, the only allowable tag words are Warning and Important. It is sometimes appropriate to use a machine-specific tag such as Apple IIe or Original Macintosh. If you have a compelling reason for using another tag word, discuss the situation with your editor.
tapDon't use when you mean press. See also click; press; type.
TeachTextOne word. Note capitalization.
Fig21
tear-off menuRefers to a menu that can be removed from the menu bar and left on the desktop either as a list of commands or as a palette. (See Figure 21.) Note hyphenation.
telecommunicationTelecommunication refers to the act; telecommunications refers to the field. When used as an adjective, the correct term is telecommunications.
Telecommunication gets simpler by the day, though you can't prove it by most manuals on this subject.
The telecommunications industry is expanding rapidly.
televisionNot television set or TV set. After the first occurrence, TV is OK. Compare videomonitor.
television monitorDon't use. Use video monitor on first mention; thereafter, monitor is OK.
textfileTwo words, except in reference to the Pascal predefined file type textfile.
text head Use different levels of text heads to make the organization of a manual clearer to the reader, but remember that too many heads too close together will distract the reader and make for a cluttered page.
In general, organize your sections so that level-four heads are subordinate to level-three heads, level-three heads to level-two heads, and so on. (Don't skip a level of heads.) When the next logical level of heading seems too prominent for a given usage (in troubleshooting chapters, for example), try to use display sentences rather than skipping a level of text heads.
Don't begin a chapter with a level-one head; start with an introductory paragraph or two before your first text head. Likewise, don't place a level-two head immediately after a level-one head, and so on. (A brief overview of a section-even if it's only a sentence-is useful before you begin using the next level of text head.)
If you use a particular level of head at all in a given chapter or section, use at least two. (Strictly speaking, a chapter or section can't be subdivided into only one part.)
The wording of parallel heads within a section should be parallel: verb forms should be the same (gerunds, imperatives, and so on) from head to head; comparable terms should all be either singular or plural, not a mix; and if you're using complete sentences for some heads, use them for all comparable heads.
Avoid cute, flippant, or gimmicky heads. Humor can be an effective means of enhancing the reader's experience, but it generally works best in the text rather than in titles or heads. Count on your prose to create the excitement necessary to carry the reader along; keep heads simple and descriptive.
The capitalization style for all levels of text heads is initial cap only. Avoid colons in heads whenever possible. If a colon in a head is required, capitalize the first word after the colon.
Cross-references to text heads are in caps/lowercase.
thatUse to introduce a restrictive clause; clauses beginning with that are generally not set off with commas. Compare which.
Correct: This is the house that Jack built. [There are many houses; the phrase that Jack built restricts (narrows the meaning of) the subject of the sentence to one house.]
Correct: The largest house in town, which Jack's sister built, is also the newest. [There is only one largest house; the phrase which Jack's sister built, while it provides more information, does not restrict the subject of the sentence.]
title page All manuals must have a title page. This page is the first in the book (page i) and does not have a page number or a running foot.
Any trademarked Apple product whose name appears on the title page must receive the appropriate trademark symbol (r or t). Unlike trademark symbols in running text, the symbols on the title page align with the base of the product name. For information on trademark symbols, see trademarks.
titles, chapterandsectionMake part titles, chapter titles, and heads concise and consistent. Keep the reader's needs in mind, and remember that these elements are used primarily as locators for someone scanning through a manual.
For functional definitions of design elements, see the appropriate specifications for designs such as Galaxy and Nova.
titles, diskSee disk titles.
titles, manualSee manualtitles.
token ring networkThree words.
toolkitTwo words.
top leftAvoid; use upper left as a noun, upper-left as an adjective.
top rightAvoid; use upper right as a noun, upper-right as an adjective.
towardNot towards.
trademarksAny trademarked Apple product mentioned in a manual must receive the appropriate trademark symbol (r or t) on first occurrence both in the preface and in the text. (Mentions in front matter other than the preface do not receive a trademark symbol.) Any trademarked product name that appears on the title page must receive the appropriate symbol both on the title page and on first occurrence in the preface and in the text.
The following uses of a name do not constitute first occurrence in text and should not receive a trademark: in a manual title used in a text cross-reference, in a heading, in a caption for a table or figure, in a marginal gloss.
Credit lines for all trademarked products (third-party as well as Apple) must be given on the copyright page.
Trademark status changes with time; for the most current listing of Apple trademarks, consult the monthly trademark and copyright update published by Apple's Legal Department.
Trademarked non-Apple products do not receive a trademark symbol in the text unless the trademark owner has entered into a special licensing agreement with Apple. (The trademark and copyright update lists all such licensed trademarks.) For licensed third-party trademarks, as for Apple trademarks, include the appropriate symbol on first occurrence in the preface and in the text.
When a product name is a trademarked term, it should be used as an adjective modifying a generic noun on first occurrence in the preface and in each chapter.
training disksSee product training disks.
troubleshoot (v.), troubleshooting (n., adj.)One word.
TVNot TV set or television set. Use television on first occurrence. Compare videomonitor.
TV monitorDon't use. Use video monitor on first mention; thereafter, monitor is OK.
25-pin connectorNote hyphenation. In user manuals, use instead of DB-25 connector. See also connector.
type (n.)Use in general references to the text that appears on a printed page. Don't use type when you mean font or font family.
type (v.)Use to describe the act of pressing keys to produce characters on the screen. In manuals, use computer voice to represent what the user actually types, regular text font to describe generically what the user types. In tour disks, use boldface rather than computer voice.
Type PR#4.
Type Hello.
Type your name.
Compare enter; press.
type-ahead (n., adj.), type ahead (v.)No hyphen in verb. Refers to the queuing of a user's keystrokes until an application is ready to process them. Compare mouse-ahead; mouse ahead.
typefaceDon't use; use font or font family, whichever is appropriate.
type familyDon't use; use font family.
type sizeDon't use; use size or font size.
uncheckDon't use; use deselect.
underliningDon't use in manuals. In training disks, use underlining instead of italics for emphasis and for new terms. (If underlining is not available, use all caps.) See also boldface; italics; quotation marks.
unhighlight (v.)Don't use when you mean deselect.
unhighlighted (adj.)Don't use; use not highlighted. Compare unselected.
UNIXrsystemA registered trademark of AT&T Information Systems. All caps, but not an acronym. UNIX is an adjective and cannot stand alone. Don't use the phrase Apple UNIX or Apple's UNIX system. When referring to Apple's version of the UNIX operating system, use A/UX.
unprotectDon't use; use remove protection.
unselected (adj.)Use to describe something that has not yet been selected. Not deselected or dehighlighted. Compare deselect; unhighlighted.
Up ArrowThe key. When referring to more than one of the arrow keys, arrow is lowercase (as in the arrow keys).
uppercase (n., adj.)One word, no hyphen. (Exception to American Heritage.) When used in conjunction with lowercase as a noun (or to modify a noun), use uppercase and lowercase (both words spelled out, in that order).
upper left (n.), upper-left (adj.)Note hyphenation of adjective. Don't use upper left-hand or top left.
upper right (n.), upper-right (adj.)Note hyphenation of adjective. Don't use upper right-hand or top right.
upside-down (adj.)Note hyphenation.
upwardNot upwards.
U.S.Note periods. (Exception to the rule that abbreviations do not include periods.)
user groupNot users group or user's group.
user nameTwo words. Note the spelling of these similar terms: device name, filename, pathname, volume name.
versionLowercase, as in AppleShare version 1.1.
versusNot vs. Rewrite to avoid using versus when possible.
videocableNot videocord or monitorcable.
videojackNot videoconnector.
videomonitorNot televisionmonitor or TVmonitor. After first occurrence, it's OK to shorten the term to monitor.
video slotDon't use; use auxiliary slot for the special slot on the Apple IIe.
viewportOne word. Don't use when you mean window.
volumenameTwo words. In specific references, capitalization should agree with the directory listing: the volume named PERSONNEL.
Note the treatment of these similar terms: device name, filename, pathname, user name.
volumesBooks are divided into volumes when page length exceeds manageable limits. Different volumes don't have different titles because the division into volumes doesn't represent a difference in subject matter. Use arabic numerals for volume numbers.
Volume1, Volume2
Inside Macintosh is an exception to this rule; its volume numbers are roman.
Volume IV of Inside Macintosh
In cross-references to specific volumes, capitalize but don't italicize Volume.
See Volume 1 of the Applesoft BASIC Programmer's Reference Manual for more information.
See also parts.
vs.Don't use; use versus when absolutely necessary.
warmstart (n.),warm-start (adj.)Note hyphenation of adjective.
waveform (n., adj.)One word.
wavelength (n.)One word.
weDon't use first person; rewrite in terms of the reader or the product.
whichUse only to introduce an unrestrictive clause; clauses beginning with which are always set off with commas. Compare that.
Correct: The largest house in town, which Jack's sister built, is also the newest. [There is only one largest house; the phrase which Jack's sister built, while it provides more information, does not restrict (narrow the meaning of) the subject of the sentence.]
Correct: This is the house that Jack built. [There are many houses; the phrase that Jack built restricts the subject of the sentence to one house.]
whirNot whirr. But whirring.
The disk drive whirs; in a moment you'll see the opening display on the screen.
wide area networkThree words.
windoidDon't use; use mini-window.
windowWhen an icon is opened, what appears on the screen is called a window, not an open window. Inactive windows or objects are in back of or behind active windows. Compare mini-window.
window zoomingNote lowercase. No hyphen.
word processing (n.), word-processing (adj.)Note hyphenation of adjective.
wordsaswordsItalicize a word when it is used as a word. Use an apostrophe and an s to form the plural, but don't italicize the apostrophe or the s.
He had too many and 's in the sentence.
word wrapNot wraparound or word wraparound. In manuals written for new users, however, you may want to mention the term wraparo
und or include it in your glossary because users may see it elsewhere.
work fileTwo words, except in reference to the Pascal predefined file type workfile.
workstation (n., adj.)One word.
wraparound (n.)Don't use; use word wrap.
write-enablenotchNot write-protectnotch. Note hyphenation. Refers to the notch on 5.25-inch disks only.
write-protect (v., adj.), write-protected (adj., pred. adj.), write-protection (n.)Hyphenated in all forms.
You use the write-protect tab to write-protect a disk.
When a disk is write-protected, it can't be changed.
Sometimes it's necessary to remove the write-protection from a disk.
xWhen used as a place holder for replaceable numbers, x is lowercase and plain style.
$02xx [represents a range of Memory Manager errors]
Don't use x 's as place holders in numbers representing microprocessors.
Incorrect: 68xxx microprocessor
Correct: 68000-family microprocessor
XON/XOFFAll caps. Refers to the handshake.
zerocharacterOK for the ASCII character $30. Don't confuse with nullcharacter ($00).
zerosNot zeroes.
zipcodeNote lowercase.
zoom boxTwo words. Note lowercase.
zoom-window boxNote lowercase and hyphenation.
A P P E N D I X A
Technical Notation
This appendix gives special style and usage rules that apply largely
or exclusively to technical documentation. (These rules are also included by topic in the main body of this guide.)
General considerations
When writing about a particular programming language, be careful to follow the capitalization style of that language.
Be sure to explain in the preface how your book uses capitalization and typography. If you use special text elements, such as tag boxes, incidental boxes, or marginal glosses, it's usually a good idea to explain your conventions for these elements as well.
Code
Use computer voice for code.
If the language you're working with has a standard style of indentation, use it. If it doesn't have such a style, develop a logical method of your own and use it consistently.
WHILE i<63 DO BEGIN IF odd(i) THEN z := z*w ELSE z := y END
Develop a method of spacing around punctuation and use it consistently. It's often best to use "English-style" spacing because it's easy to remember and stick with.
Use computer voice for literals (parts of the language, values, and so on), regular text font italics for metasymbols (artificial terms that have meaning only in your book and are to be replaced by a value or symbol), and plain style regular text font for brackets that enclose something that's optional. Pay close attention to punctuation.
Read ([file, ] var)
Use a hyphen or an embedded cap to connect two words that act as a single metasymbol.
Correct: source-file or sourceFile
Incorrect: sourcefile or source_file
The hyphen is preferred to the embedded cap because it avoids confusion of the metasymbol with a Macintosh routine name.
Be consistent when naming metasymbols; for example, don't alternate between commands and command-list.
Computer voice in text
Whether to use computer voice in text is a matter of judgment. Use computer voice only if your manual would be confusing without it; for example, if your manual has at least several instances in which a word from a programming language might be mistaken for an English word. If a programming language has a capitalization convention that already distinguishes such words, however, computer voice need not be used.
Likely places for computer voice in text would be language manuals, A/UX references, and other highly technical manuals. (In most other kinds of manuals, words that would be candidates for computer voice are usually routine names and field names, which have a capitalization style that already distinguishes them.)
If you decide that you need computer voice in text, use it for all text fragments that the reader should construe as expressions in a programming language. For example, in a language manual you would use computer voice for such elements as data types, reserved words, operators, quoted constants, nonnumeric values, and identifiers (names for variables, routines, and so on)-that is, anything that should be read as code.
Be aware that some words have more than one meaning in some manuals, such as real in computer voice for the data type and in regular text font for the class of types in MPW Pascal.
You may choose to use computer voice for the names of files, volumes, directories, and libraries, especially in reference books for languages and development systems where the filenames are names of pieces of code.
/CIIgsLibraries/Start.obj
/etc/sysinitrc
Such names are a special case because they are not part of executable code.
In general, don't use a routine name as a verb.
Correct: Run ls on both directories.
Incorrect: ls both directories.
Correct: Change to the root directory.
Incorrect: cd to the root directory.
But when a routine name is also an English word and is well established as a verb with your audience, it's OK to use the name as a verb; use regular text font for this purpose. The verb in this example would be recognized by A/UX readers as concatenate:
Correct: Cat your file.
Incorrect: cat your file.
Avoid mixing fonts within a single word. Rewrite to avoid forming the plural of a word in computer voice.
Correct: values of type integer
Incorrect: integers
Punctuation following a word or phrase in computer voice is in regular text font, not in computer voice, unless the punctuation mark is part of the computer-language element represented.
NAN(004), nan(4), and NaN are examples of acceptable input.
Use computer voice spaces before and after a word or phrase in computer voice. (Computer voice spaces are wider than regular text font spaces.)
Metasymbols in text
In running text, use regular text font italics when referring to a metasymbol (that is, an artificial term that has meaning only in your manual and is to be replaced by a value or symbol), and spell out the metasymbol just as it would appear in a syntax description. Use plain style when using the name of a metasymbol as ordinary prose.
Correct: volume-name may have up to 12 characters.
Correct: The volume name may have up to 12 characters.
Incorrect: The volume-name may have up to 12 characters.
A P P E N D I X B
Units of Measurement
THIS APPENDIX LISTS UNITS OF MEASUREMENT LIKELY TO OCCUR IN A COMPUTER
manual. For each unit, both the full term and the abbreviation are given, along with the quantity for which the unit is used.
Guidelines
Use the full term for a unit of measurement in text; abbreviations are fine in technical appendixes, specification lists, and tables.
Abbreviations for metric units are not followed by a period; abbreviations for English units are followed by a period. In general, units of measurement derived from a proper name are not capitalized when spelled out, but their abbreviations are capitalized.
Use the same abbreviation for both the singular and the plural form of a unit of measurement. Exceptions to this rule are the abbreviations Kbit, Kbyte, and Mbit, which take the forms Kbits, Kbytes, and Mbits when used as abbreviations for kilobits, kilobytes, and megabits.
When using a numeral and a unit of measurement as a compound adjective, hyphenate the compound even when the unit is abbreviated. Exceptions to this rule are the abbreviation K, which is closed up with the numeral even when it is used to form an adjective, and the abbreviation MB, which is left open even when it is used to form an adjective.
When an abbreviation includes a nonalphanumeric character, the keystroke sequence necessary to generate that character is included in brackets after the abbreviation.
Ah rate of delivery of electricity ampere per meter
A/m magnetic field strength ampere per volt. See siemens ampere-second. See coulomb angstrom (10-10 meters)
A [Option-Shift-A] optical wavelength attoampere (10-18 amperes)
aA electric current baud (signal events per second)
baud speed of data transmission bel (10 decibels)
B sound intensity bits per second
bps speed of data transmission
calorie (thermochemical calorie) cal or C heat candela (or candle)
cd [with metric luminous intensity units] or cd. [with English units] candela per square inch
cd./sq. in. luminance candela per square meter
cd/m2 luminance centimeter
cm length centimeter per second per second. See gal
characters per inch cpi letter spacing (in type)
characters per second cps printing speed (on nonlaser printers)
coulomb (ampere-second) C electric charge coulomb per volt. See farad cubic centimeter cm3 volume cubic foot
cu. ft. volume cubic foot per minute cu. ft./min. change in volume over time cubic foot per second cu. ft./sec. change in volume over time cubic inch cu. in. volume cubic meter m3 volume cubic meter per second m3/s change in volume over time cubic yard cu. yd. volume cycle c complete execution of a periodically repeated phenomenon cycle per second. See hertz decibel (0.10 bels) dB sound intensity degree o [Option-Shift-8] angular measure degree Celsius oC [Option-Shift-8] temperature degree Fahrenheit oF [Option-Shift-8] temperature degree Kelvin. See kelvin degree Rankine oR [Option-Shift-8] temperature dyne dyn force
electromotive force emf energy derived from electrical source per unit quantity of electricity electron volt eV energy erg erg workfarad (coulomb per volt) F capacitance foot ft. length foot per minute ft./min. velocity foot per second ft./sec. velocity foot per second squared ft./sq. sec. acceleration gal (centimeter per second gal acceleration, especially that per second) due to gravity gallon gal. volume gauss G magnetic induction gigabit Gbit computer memorygigabyte GB computer memorygigaelectron-volt (109 GeV energy electron volts) gigahertz (109 hertz) GHz frequency gilbert Gb magnetomotive force gram g mass, weight gram per cubic centimeter g/cm3 density henry H inductance hertz (cycle per second) Hz frequency horsepower HP power hour h [with metric units] time or hr. [with English units] inch in. length inch per second in./sec. velocity joule (kilogram-meter) J energy joule per second. See watt kelvin K temperature kilobit Kbit computer memory kilobyte K or KB computer memory kilogauss (103 gauss) kG magnetic induction kilogram (103 grams) kg mass, weight kilogram-meter. See joule kilogram-meter per second squared. See newton kilogram per cubic meter kg/m3 density kilohertz (103 hertz) kHz frequency kilohm (103 ohms) kO [Option-Z] electric resistance kilometer (103 meters) km length, distance kilometer per hour kph or KPH velocity
kilovolt (103 volts) kV electric potential kilovolt-ampere. See kilowatt kilowatt (kilovolt-ampere) kW power kilowatt-hour kWh energy (usually electric power consumption) liter l volume liter per second l/s change in volume over time lumen lm flux of light lumen per square centimeter. See phot lux lx illumination maxwell (10-8 webers) Mx magnetic flux megabit Mbit computer memory megabyte MB computer memory megaelectron-volt (106 MeV energy electron volts) megahertz (106 hertz) MHz frequency megohm (106 ohms) MO [Option-Z] electric resistance meter m length, distance meter per second m/s velocity meter per second squared m/s2 acceleration microampere (10-6 amperes) uA [Option-M] electric current microfarad (10-6 farads) uF [Option-M] capacitance microgram (10-6 grams) ug [Option-M] mass, weight microhenry (10-6 henrys) uH [Option-M] inductance microliter (10-6 liters) ul [Option-M] volume micron or micrometer um [Option-M] length (10-6 meters) mil (10-3 inches) mil length mile mi. [except in mph] length, distance mile per hour mph or MPH velocity milliampere (10-3 amperes) mA electric current milligram (10-3 grams) mg mass, weight millihenry (10-3 henrys) mH inductance milliliter (10-3 liters) ml volume millimeter (10-3 meters) mm length millimicron. See nanometer millisecond (10-3 seconds) ms time millivolt (10-3 volts) mV electric potential milliwatt (10-3 watts) mW power minute min. time month mo. time nanoampere (10-9 amperes) nA electric current
nanofarad (10-9 farads) nF capacitance nanometer (10-9 meters) nm length nanosecond (10-9 seconds) ns time newton (kilogram-meter per N force second squared) newton per square meter. See pascal oersted Oe magnetic intensity ohm O [Option-Z] electric resistance ounce oz. volume, weight pascal (newton per square meter) Pa pressure phot (lumen per square centimeter) ph illumination picofarad (10-12 farads) pF capacitance picowatt (10-12 watts) pW power pound lb. mass, weight poundal pdl. force radian rad or radian angular measure radian per second rad/s angular velocity radian per second squared rad/s2 angular acceleration revolution per minute rpm angular velocity rod (5.5 yards) rd. length second s [with metric units] time or sec. [with English units] siemens (ampere per volt) S conductance slug slug mass square foot sq. ft. area square inch sq. in. area square meter m2 area square mile sq. mi. area square rod sq. rd. area square yard sq. yd. area tesla (weber per square meter) T magnetic flux density ton tn. or ton mass, weight volt V electric potential volt-ampere. See watt watt (joule per second) W power watt-hour Wh energy weber Wb magnetic flux weber per square meter. See tesla yard yd. length, distance year yr. time
The Apple Publishing System
This Apple manual was written, edited, and composed on a desktop publishing system using Apple Macintoshrcomputers and MicrosoftrWord. Proof pages were created on Apple LaserWriterr printers; final pages were created on the Varityperr VT600t. PostScriptr, the LaserWriter page-description language, was developed by Adobe Systems Incorporated.
Text type and display type are Apple's corporate font, a condensed version of Garamond. Bullets are ITC Zapf Dingbatsr. Some elements, such as program listings, are set in Apple Courier, a fixed-width font.
